home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir25 / qbook100.zip / QBOOK.DOC < prev    next >
Text File  |  1994-07-31  |  49KB  |  992 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                 QBook Recipe Manager
  20.                                     Version 1.00
  21.  
  22.  
  23.  
  24.                                     User's Guide
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                              Copyright (C) 1989-1994 by
  36.                                   Robert J. Butler
  37.                                  All Rights Reserved
  38.  
  39.  
  40.                                   Robert J. Butler
  41.                                  2023 38th Street NW
  42.                                 Rochester, MN  55901
  43.  
  44.           QBook Version 1.00     User's Guide                  Page:2
  45.  
  46.  
  47.                                   Table of Contents
  48.  
  49.           WHAT IS QBOOK?..................................................3
  50.  
  51.             QBook's  Features:............................................3
  52.  
  53.           LICENSE.........................................................4
  54.  
  55.  
  56.           STANDARD DISCLAIMER.............................................4
  57.  
  58.  
  59.           INSTALLATION....................................................5
  60.  
  61.  
  62.           GETTING HELP....................................................5
  63.  
  64.  
  65.           STARTING QBOOK..................................................6
  66.  
  67.  
  68.           USING QBOOK.....................................................7
  69.  
  70.             Adding Recipes................................................7
  71.               QBook's Recipe Editor.......................................8
  72.               Entering Recipes............................................9
  73.             Display a Recipe.............................................10
  74.             Print an Index...............................................11
  75.             View all of the Titles.......................................11
  76.             Search for Recipes...........................................12
  77.             Import Recipes...............................................13
  78.  
  79.           THE IMPORT SCREEN..............................................14
  80.  
  81.  
  82.           THE TITLE VIEW SCREEN..........................................15
  83.  
  84.  
  85.           CONFIGURING QBOOK..............................................17
  86.  
  87.             Display Options..............................................17
  88.             Printer Configuration........................................17
  89.             Editor Options...............................................18
  90.             Recipe Storage Options.......................................19
  91.             Data File Directories........................................20
  92.             QBook Utilities..............................................20
  93.             Registration Information.....................................20
  94.  
  95.           TECHNICAL INFORMATION..........................................21
  96.  
  97.  
  98.           REGISTRATION FORM..............................................22
  99.  
  100.           QBook Version 1.00     User's Guide                  Page:3
  101.  
  102.  
  103.                                    What is QBook?
  104.  
  105.  
  106.           QBook is a program which helps you maintain a database of
  107.           recipes.   It is designed to flexible, powerful and easy to use.
  108.  
  109.           QBook's  Features:
  110.              - Recipes can be typed in any format you want or no format at
  111.                all
  112.              - Stored recipes can optionally be automatically compressed to
  113.                save disk space.
  114.              - Recipes can be easily imported to the database from a
  115.                variety of sources including recipes captured from on-line
  116.                services and BBS's and recipes scanned and converted with
  117.                OCR.
  118.              - Recipes can be easily exported from QBook to a text file for
  119.                easy sharing with others.
  120.              - The database can be searched using AND/OR/NOT operations
  121.              - Recipes can be added and edited using either QBook's built-
  122.                in editor or your favorite ASCII editor or word processor.
  123.  
  124.           QBook Version 1.00     User's Guide                  Page:4
  125.  
  126.  
  127.                                        License
  128.  
  129.           QBook is Shareware.  It is NOT Public Domain software and it is
  130.           NOT free software.
  131.  
  132.           The program QBook, this document and the help screens displayed
  133.           within QBook are all Copyright (C) 1994 by Robert J. Butler.  All
  134.           rights reserved.  You may use, copy and distribute QBook only
  135.           under the following conditions:
  136.  
  137.           Non-registered users have a limited license to use QBook on their
  138.           systems for an evaluation period of thirty days.  Any use beyond
  139.           this period requires that QBook be registered with the author.
  140.  
  141.           QBook may not be modified in any way for any reason.  This
  142.           includes, but is not limited to, removal of the opening
  143.           "reminder" screen.  The only legal way to remove this screen is
  144.           to register the program.
  145.  
  146.           You may distribute QBook to others under the following
  147.           conditions:
  148.  
  149.           1)   You distribute only the Shareware version and do not
  150.                distribute the registration key or any programs or utilities
  151.                that are provided to registered users.
  152.           2)   The program is distributed in its original form and with its
  153.                original files.  You may, however, change from one
  154.                compressed format to another (i.e.: from ZIP to ARC)
  155.                provided all files are kept in the compressed file.
  156.           3)   If you charge to distribute the program, you must CLEARLY
  157.                AND EXPLICITLY STATE to your customers that the fee you
  158.                charge does not register the program, and that they are
  159.                still required to register the program with the author if
  160.                they use it beyond the evaluation period.
  161.  
  162.  
  163.  
  164.                                  Standard Disclaimer
  165.  
  166.  
  167.           QBook is provided AS IS with no expressed or implied warranties.
  168.  
  169.           Use QBook at your own risk.  The author will not be liable for
  170.           any damages or loss of data resulting either directly or
  171.           indirectly from the use of the program.  The author will not be
  172.           responsible if the program fails to operate as desired by the
  173.           user or as described in this manual or the help screens.
  174.  
  175.           The author intends to provide support for QBook and has every
  176.           intention of providing updates and bug fixes.  There is, however,
  177.           no obligation on his part to do so.
  178.  
  179.           Put simply, the program comes with absolutely no guarantees.
  180.           The program has been thoroughly tested, but it is always possible
  181.           to miss something.  Always keep backups of your data.
  182.  
  183.           QBook Version 1.00     User's Guide                  Page:5
  184.  
  185.  
  186.                                     Installation
  187.  
  188.  
  189.           To install QBook, copy the file QBOOK.EXE, MESSAGES.QBK,
  190.           MESSAGES.IDX and QBOOK.HLP to whatever disk and subdirectory you
  191.           desire (i.e.: C:\QBOOK)
  192.  
  193.           The standard installation should work well for most users.
  194.           QBook's internal editor will be used for creating and editing
  195.           recipes, and recipes will be stored in compressed form using
  196.           QBook's internal compression routines.  If you are running QBook
  197.           on a disk drive that uses a disk compression technology (such as
  198.           Stac Electronics' Stacker), you may want to turn off compression
  199.           (See "Configuring QBook").
  200.  
  201.           Once you are comfortable with QBook, you may want to explore some
  202.           of the advanced configuration options (See "Configuring QBook").
  203.  
  204.  
  205.                                     Getting Help
  206.  
  207.           QBook has two levels of help. "Help Mode", which can be turned on
  208.           and off using the F1 key, gives you a brief description of each
  209.           menu option on the main set of popup menus.
  210.  
  211.           QBook also has a fairly extensive context-sensitive help system
  212.           which provides help for each of the functions QBook provides.
  213.           Much of the help information duplicates what is found in this
  214.           user's guide, but is much more accessible.
  215.  
  216.           Unless QBook is busy printing or reading or writing to the disk,
  217.           the Alt-F1 key combination will almost always pop up a help
  218.           screen.  Many help screens have more than one page, and you can
  219.           see additional information by pressing the Page Down (marked
  220.           PGDN) key.  Each help screen is linked to related help topics,
  221.           you can select the topic you wish to view with the arrow keys and
  222.           then press ENTER.
  223.  
  224.           Part of the help system is an Overview of QBook.  This overview
  225.           gives you a brief description of each of QBook's features.  It is
  226.           recommended that you read the overview before using QBook for the
  227.           first time.
  228.  
  229.           The Help Index is selectable from all of the help screens except
  230.           the overview screens and lists all of the help topics that are
  231.           available.
  232.  
  233.           Another key that is useful is the ESCAPE key.  This key will get
  234.           you out of wherever you are and pressing it repeatedly will
  235.           eventually bring you to the main screen.  Pressing escape from
  236.           the main screen will cause QBook to ask you if you are sure you
  237.           want to exit.  If you do, press Y, if not, press N.
  238.  
  239.           QBook Version 1.00     User's Guide                  Page:6
  240.  
  241.  
  242.                                    Starting QBook
  243.  
  244.           Type QBOOK at the DOS prompt. The first time you run QBook,  it
  245.           will ask you "Is this the first time you have run QBook?"  It
  246.           does this because it was unable to find QBook's configuration
  247.           file (which contains information on how you want the program to
  248.           work).  If you answer 'Y' to this question, QBook will initialize
  249.           itself by creating its configuration and index files.  Once it
  250.           has initialized, QBook will automatically display a help window
  251.           which will allow you to walk through a brief overview/tutorial.
  252.  
  253.           QBook accepts three command line parameters.  If you have an
  254.           older color adapter and the screen flickers when QBook runs, you
  255.           can turn on CGA snow checking by typing "QBOOK /S+" at the DOS
  256.           prompt
  257.  
  258.           QBook normally writes direct to video memory.  This is a fast
  259.           method of displaying information on the screen, but occasionally
  260.           causes problems (for example in an older multitasking
  261.           environment).  If you want QBook to use BIOS screen writes
  262.           instead of direct screen writes, type  "QBOOK /B+" at the DOS
  263.           prompt.
  264.  
  265.           Both snow checking and BIOS writes can be turned on permanently
  266.           (see Configuring QBook).
  267.  
  268.           The final command line parameter tells QBook that you want to
  269.           make configuration changes before it tries to load its data
  270.           files.  For example, if you move the data files to a different
  271.           directory in DOS instead of  letting QBook move them for you,
  272.           QBook will not know where to find them.  You can type "QBOOK
  273.           /CFG" at the DOS prompt and you will go directly to the
  274.           configuration menu where you can make your changes.
  275.  
  276.           QBook Version 1.00     User's Guide                  Page:7
  277.  
  278.  
  279.                                      Using QBook
  280.  
  281.  
  282.           Adding Recipes
  283.  
  284.            A "recipe" to QBook can be anything at all.  It doesn't need to
  285.            be instructions for preparing a food item.  For example, if you
  286.            have a lot of cookbooks with favorite recipes, rather than
  287.            typing them into QBook you can simply add a "recipe" that is a
  288.            reference to the page number in your cookbook.  This way you
  289.            can utilize the searching capabilities of QBook without having
  290.            to type in recipes that you already have somewhere else.
  291.  
  292.            Other ideas are to store conversion tables or titles of
  293.            cookbooks that you'd like to find someday.  QBook makes them
  294.            easy to find when you need them.
  295.  
  296.            To add a recipe, simply choose the option from the main menu.
  297.  
  298.            When you add a recipe, QBook creates a temporary file called
  299.            RECIPE##.###, where ##,### is the number of the recipe being
  300.            created.  If you create a file named TEMPLATE.QBK and place it
  301.            in your data directory, QBook will use that as a template
  302.            (everything in it will be copied to your new recipe prior to
  303.            loading the editor) when you create a new recipe.  If it is not
  304.            found, QBook will put create a file with a "Title:" line and a
  305.            "Keyword:" line for you.
  306.  
  307.           QBook Version 1.00     User's Guide                  Page:8
  308.  
  309.  
  310.           QBook's Recipe Editor
  311.  
  312.           Unless you have configured an external editor, QBook will use its
  313.           internal editor for adding and editing recipes.  This is a fairly
  314.           simple editor, but it should be sufficient for most users.  The
  315.           editor will automatically wrap text at the column number you
  316.           specified when you chose the internal editor (column 75 if you
  317.           never changed it).  The internal editor understands the following
  318.           keys:
  319.  
  320.  
  321.           Movement:                  :                  :
  322.  
  323.              Arrow keys: Move the cursor one character up, down, left or
  324.                          right
  325.              Ctrl-right
  326.              Ctrl-left:  Move the cursor left or right one word
  327.              Home/End:   Move the cursor to the beginning or end of the
  328.                          current line
  329.              PgUp/PgDn:  Move to the next/previous page of the recipe
  330.              Ctrl-PgUp
  331.              Ctrl-PgDn:  Move to the beginning or end of the recipe
  332.  
  333.  
  334.           Deletion:                  :                  :
  335.  
  336.              Backspace:  Delete the character immediately to the left of
  337.                          the cursor
  338.              Del:        Delete the character under the cursor
  339.              Ctrl-End:   Delete from the cursor to the end of the current
  340.                          line
  341.              Ctrl-Y:     Delete the current line
  342.              Ctrl-T:     Delete the word to the right of the cursor
  343.              Ctrl-R:     Delete the word to the left of the cursor
  344.              Ins:        Toggle between overtype and insert modes
  345.  
  346.  
  347.           Other:               :               :
  348.  
  349.              F7:         Record a sequence of keystrokes (F7 again to stop
  350.                          recording)
  351.              F8:         Playback the recorded sequence of keystrokes
  352.              Alt-B:      Reformat the current paragraph to the margins
  353.                          specified in the configuration
  354.              Alt-S:      Save the recipe
  355.              Alt-X/Esc:  Quit the editor, prompt to save if the current
  356.                          recipe is unsaved.
  357.  
  358.           QBook Version 1.00     User's Guide                  Page:9
  359.  
  360.  
  361.           Entering Recipes
  362.  
  363.            One of QBook's advantages is that recipes can be formatted any
  364.            way you desire.  In order to index your recipes, however, QBook
  365.            requires that you type in a title and keywords for the recipe.
  366.  
  367.            The first thing you should do is type in the title of the
  368.            recipe you are adding.  If you want to take advantage of
  369.            QBook's indexing and searching capabilities, the next thing you
  370.            should do is add keywords, which are used by QBook to search
  371.            for a recipe.  You do this by typing "Keywords: " (if it isn't
  372.            already there) on line two and then typing in your keywords
  373.            separated by commas.  If you have too many keywords to fit on a
  374.            line (80 characters across), just add another line beginning
  375.            with "Keywords: ".   Do not put a comma at the end of a
  376.            keywords line, even if there are more keywords on the next
  377.            line.
  378.  
  379.            Choosing keywords carefully makes it much easier for you to
  380.            find the recipe you are looking for.  QBook doesn't have the
  381.            capability to search ingredients or the text of the recipe, so
  382.            it is a good idea to list major ingredients as keywords.  The
  383.            best way to choose keywords is to think in terms of an index in
  384.            a cookbook:  What would you look under if you wanted to find
  385.            this recipe and couldn't remember the title?  You can have as
  386.            many keywords as you want.  Only the first 60 characters of a
  387.            keywords or title are indexed.
  388.  
  389.            Once you have entered your title and keywords, all you need to
  390.            do is type in your recipe.  Each line of your recipe should be
  391.            less than 80 characters.  Once you are done, save the file and
  392.            exit the editor.  QBook will add the recipe to the index and
  393.            move the temporary recipe file into a compressed data file and
  394.            then delete it.
  395.  
  396.           QBook Version 1.00     User's Guide                  Page:10
  397.  
  398.  
  399.           Display a Recipe
  400.  
  401.            To display a recipe, choose the option from the main menu, type
  402.            the recipe number and press Enter.  You can also display
  403.            recipes from the title view screen by selecting the desired
  404.            title  with the arrow keys and choosing Display from the menu
  405.            (see Viewing Titles and Searching for Recipes).
  406.  
  407.            When a recipe is displayed, the title, recipe number and
  408.            keywords are displayed on top.  This header information does
  409.            not scroll, the rest of the recipe can be scrolled with the Up,
  410.            Down, PGUP and PGDN, Home and End keys.  The Up and Down arrow
  411.            keys scroll up or down one line at a time, PGUP and PGDN scroll
  412.            a whole page at a time.  Home displays the first page of the
  413.            recipe, End displays the last.
  414.  
  415.            A flashing '*' next to the title of the recipe indicates that
  416.            there are more than one recipe with the same title in the
  417.            database (see Locating Duplicate Recipes).  A flashing '+' at
  418.            the end of the keywords line indicates that there are more
  419.            keywords than can be displayed on a single line.
  420.  
  421.            The bottom two lines of the display screen are a menu listing
  422.            the display options.  The options are as follows:
  423.  
  424.            Edit:      Edit the displayed recipe with the editor.  This
  425.                       option allows you to make changes to the displayed
  426.                       recipe.  When you exit the editor, QBook will update
  427.                       its indexes and replace the old copy of the recipe in
  428.                       the compressed data file.
  429.            Print:     Print the displayed recipe.  QBook will prompt you
  430.                       for the printer setup to use and the output device or
  431.                       file to send the recipe to.  See Configuring QBook
  432.                       for information on printer setups.
  433.            Export:    Write the displayed recipe to a disk file with begin
  434.                       and end markers so that it can be easily imported
  435.                       into another QBook database and/or posted to an
  436.                       electronic Bulletin Board.
  437.            Keywords:  Display all of the keywords in the recipe and allow
  438.                       you to add, delete or change them.
  439.            Title:     Edit the title of the recipe.
  440.            Delete:    Delete the displayed recipe from the database.  You
  441.                       will be asked to verify the deletion.
  442.            + and -:   These options only appear when you choose display
  443.                       from the Title View screen.  They allow you to step
  444.                       through the list of titles without returning to the
  445.                       Title View Screen between recipes.
  446.  
  447.           QBook Version 1.00     User's Guide                  Page:11
  448.  
  449.  
  450.           Print an Index
  451.  
  452.            There are three types of indexes that can be printed:  titles,
  453.            keywords and combined.  The title index lists all titles in
  454.            alphabetical order, along with the recipe numbers (which are
  455.            assigned in order as you add or import recipes).
  456.  
  457.            The keyword index lists the titles alphabetically, but grouped
  458.            by keywords.  For example: The keyword "Candies" would be
  459.            listed followed by an indented list of the titles of all
  460.            recipes containing that keyword.  Recipe titles are ONLY listed
  461.            under the appropriate keywords, if a recipe does not contain
  462.            any keywords, it WILL NOT BE PRINTED in the keyword index.
  463.  
  464.            The combined index, as the name suggests, is a combination of
  465.            the keyword index and the title index.  The combined index
  466.            resembles a good cookbook index where you can look up either a
  467.            keyword or a title.  Titles appear in boldface in the
  468.            alphabetical listing along with the keywords, they also appear
  469.            in the indented list of each keyword that the recipe is indexed
  470.            under.
  471.  
  472.  
  473.           View all of the Titles
  474.  
  475.            View all of the Titles will display QBook's Title View screen
  476.            with all recipes displayed.  This screen consists of a list of
  477.            recipe titles with a menu across the bottom.  Choosing this
  478.            option is identical to choosing Search for Recipes and entering
  479.            a blank search string.
  480.  
  481.           QBook Version 1.00     User's Guide                  Page:12
  482.  
  483.  
  484.           Search for Recipes
  485.  
  486.            Search for Recipes will Display a popup window which allows you
  487.            to enter a search string and modify the search options.  The
  488.            search string is a word or partial word that you want QBook to
  489.            locate in the index.  A blank search string matches all of the
  490.            recipes and is identical to choosing View all of the Titles
  491.            from the main menu.  You have three options when searching the
  492.            index:
  493.  
  494.            Quick Search:      Quick search uses a very fast  search method
  495.                               to find recipes.  However, only those recipes
  496.                               where the search string matches the beginning
  497.                               of a title or keyword will be matched.  For
  498.                               example, if you search on "Chicken", "Chicken
  499.                               Stir Fry" would match, but "Stir Fried
  500.                               Chicken" would not.  Careful use of keywords
  501.                               can give you the speed advantage of Quick
  502.                               Search and still give you flexible searches.
  503.                               For example, if you gave "Stir Fried Chicken"
  504.                               a keyword of "Chicken" it would have matched
  505.                               in the above example.
  506.  
  507.                               If you turn Quick Search Off, QBook examines
  508.                               each entry in the index and matches all
  509.                               recipes where the search string appears
  510.                               anywhere in the title or keyword.  In the
  511.                               above example, Full Search WOULD match "Stir
  512.                               Fried Chicken, even if you didn't give it a
  513.                               keyword of "Chicken". Full Search is much
  514.                               slower than quick search, but gives you more
  515.                               matches if the keywords are not detailed
  516.                               enough.
  517.  
  518.            Search Titles:     This option tells QBook to include a recipe
  519.                               when its title matches the search.  This is
  520.                               normally set to Yes.
  521.  
  522.            Search Keywords:   This option tells QBook to include a recipe
  523.                               when one of its keywords matches the search.
  524.                               This is normally set to yes.
  525.  
  526.           QBook Version 1.00     User's Guide                  Page:13
  527.  
  528.  
  529.            Import Recipes
  530.  
  531.             When you choose the Import Recipes option from the main menu,
  532.             you will be prompted for a file name to import.  Once you have
  533.             entered a file name, the Import screen will be displayed.
  534.  
  535.             Importing and exporting provide an easy way of exchanging
  536.             recipes.  When you export a recipe, QBook writes the recipe,
  537.             its title and all its keywords into a file along with lines
  538.             that mark the beginning and end of the recipe.  The markers are
  539.             necessary because one file can contain many exported recipes
  540.             and QBook needs to be able to tell where one recipe ends and
  541.             another begins.  An exported recipe isn't formatted in any
  542.             special way, aside from the begin and end markers.
  543.  
  544.             Exporting provides an easy way to exchange recipes.  Just give
  545.             a file of exported recipes to someone, either on floppy disks
  546.             or by uploading to a computer bulletin board system (BBS), and
  547.             that person can quickly import all of the recipes into his or
  548.             her copy of QBook.  Exported recipes can also be posted as
  549.             messages on a computer BBS and other users can save them and
  550.             import them.
  551.  
  552.             Importing is the complement of exporting.  When you import a
  553.             recipe, QBook reads a file that has been exported by someone
  554.             else and adds the recipe to your database without you having to
  555.             type the recipe in.
  556.  
  557.             QBook understands the export format of several recipe
  558.             databases, but sometimes you will need to interactively import
  559.             recipes by telling QBook where a recipe begins and ends.
  560.             QBook allows you to either quickly import all delimited recipes
  561.             in a file, or to scan through a text file and interactively
  562.             mark and edit keywords and titles prior to importing a recipe.
  563.  
  564.           QBook Version 1.00     User's Guide                  Page:14
  565.  
  566.  
  567.                                   The Import Screen
  568.  
  569.             The import screen can be in several different modes, depending
  570.             on the previous options you have chosen you may be in Scan
  571.             mode, Clip mode, or Recipe Display mode.
  572.  
  573.             The following options are common to all of the modes:
  574.  
  575.             Find:   Find the next recipe which is delimited with begin and
  576.                     end markers.
  577.             Begin:  Make the cursor line the first line of the recipe,
  578.                     clipping out all lines above it.
  579.             End:    Make the cursor line the last line of the recipe,
  580.                     clipping out all lines below it.
  581.             Global: Import all delimited recipes in the import file
  582.                     starting at the cursor location.  If a recipe is
  583.                     currently being displayed in recipe display mode, it
  584.                     will be imported even if the cursor is not at the top
  585.                     of the recipe.
  586.  
  587.             Scan mode is the mode you are in when you fist see the Import
  588.             screen.  The entire import file can be scrolled by using the
  589.             cursor keys.  You have the following additional option when in
  590.             Scan Mode:
  591.  
  592.             Remember:    This is used if you want QBook to include a line
  593.                          of text that is not included in the delimited part
  594.                          of the recipe.   For example, if you are importing
  595.                          recipes captured from a BBS and want to remember
  596.                          who posted the recipe, you could "Remember" the
  597.                          From line of the message and QBook would append it
  598.                          to the recipe when you import it.  The remembered
  599.                          line is displayed at the bottom of the screen,
  600.                          just above the menu bar.  To delete a remembered
  601.                          line, simply "Remember" a blank line.
  602.  
  603.             QBook enters Clip Mode when you have marked either the
  604.             beginning or end of a recipe, but not both.  In addition to the
  605.             options listed above, you also have the following new option:
  606.  
  607.             Unmark:      This option will return you to scan mode, again
  608.                          allowing you to view the entire import file.
  609.  
  610.             Finally, Recipe View Mode is entered when you have either used
  611.             the "Find" function to locate a delimited recipe, or you have
  612.             marked both begin and end lines of a recipe.  The "Remember"
  613.             option is not available, but the "Unmark" option is.  You also
  614.             have the following new options:
  615.  
  616.             Keywords:    Display all of the keywords in the recipe and
  617.                          allow you to add, delete or change them.
  618.             Title:       Edit the title of the displayed recipe.
  619.  
  620.           QBook Version 1.00     User's Guide                  Page:15
  621.  
  622.  
  623.                                 The Title View Screen
  624.  
  625.  
  626.             On the Title View screen, you can use the up and down arrow
  627.             keys, the PgUp, PgDn, Home and End keys to move through the
  628.             list.  Home and End will move you to the top or bottom recipe
  629.             on the current screen.  If pressed a second time, they will
  630.             move you to the first or last recipe respectively.  You may
  631.             also move directly to a recipe by typing in its number.
  632.  
  633.             Pressing the space bar will mark or unmark the currently
  634.             highlighted recipe so that you can perform a function on a
  635.             group of recipes at the same time.
  636.  
  637.             Your menu choices are as follows:
  638.  
  639.             Display:     Display the currently highlighted recipe.
  640.             Print:       Print all marked recipes. QBook will prompt you
  641.                          for the printer setup to use and the output device
  642.                          or file to send the recipes to.  See Configuring
  643.                          QBook for information on printer setups.  If no
  644.                          recipes are marked, the currently highlighted
  645.                          recipe will be printed.
  646.             Export:      Write all of the marked recipes to a disk file
  647.                          with begin and end markers so that they can be
  648.                          easily imported into another QBook database and/or
  649.                          posted to an electronic Bulletin Board..  If no
  650.                          recipes are marked, the currently highlighted
  651.                          recipe will be exported.
  652.             Delete:      Delete all of the marked recipes from the database
  653.                          (you will have an opportunity to cancel).  If no
  654.                          recipes are marked, the currently highlighted
  655.                          recipe will be deleted.
  656.             Mark:        Mark all recipes in the list so they can be
  657.                          printed, exported or deleted.
  658.             UnMark:      Unmark all marked recipes.
  659.  
  660.           QBook Version 1.00     User's Guide                  Page:16
  661.  
  662.  
  663.  
  664.           Search:   The search option allows you to narrow or broaden the
  665.                     your list of recipes by searching on additional
  666.                     keywords/titles.  The search options will be the same
  667.                     as those you used the last time you chose Search for
  668.                     Recipes from the main menu.  You have three search
  669.                     methods:
  670.  
  671.                AND: An AND search will narrow the list to all the recipes
  672.                     in the current search group that also match the also
  673.                     match the new search string.
  674.                OR:  An OR search will expand the list by searching the
  675.                     whole QBook index and adding all recipes that match the
  676.                     new search string to the currently displayed list.
  677.                NOT: A NOT search will locate all recipes in the currently
  678.                     displayed list that match the search string and remove
  679.                     them from the currently displayed list.
  680.           Flag
  681.           UnFlag:   This option is used to toggle marking of  potential
  682.                     duplicate recipes with a flashing '*'.  You may then
  683.                     use the '*' menu option to locate all recipes with the
  684.                     same title and display them to determine if they are
  685.                     indeed duplicates.
  686.           *:        This option is only available when in duplicate
  687.                     flagging mode.  If you press it when a recipe marked
  688.                     with a flashing '*' is highlighted, you will be shown a
  689.                     list of all recipes that have that title.
  690.           0-9:      Typing a number will pop up a prompt asking you for the
  691.                     recipe number to jump to.  If the recipe is in the
  692.                     current list, the list will scroll immediately to that
  693.                     recipe.
  694.  
  695.           QBook Version 1.00     User's Guide                  Page:17
  696.  
  697.  
  698.                                   Configuring QBook
  699.  
  700.             The first time you  use QBook, it will set up the default
  701.             configuration and display the configuration menu so you can
  702.             make whatever customizations you desire.   The configuration
  703.             menu has the following choices:
  704.  
  705.  
  706.           Display Options
  707.  
  708.             The Display Options menu choice allows you to choose between
  709.             three built in color schemes (one monochrome and two color) or
  710.             to create your own.  You may also set options to prevent "snow"
  711.             on a CGA display or to force video to be in BIOS mode, which
  712.             may solve compatibility problems with older multitaskers or
  713.             speech equipment.
  714.  
  715.  
  716.           Printer Configuration
  717.  
  718.             The Printer Configuration menu choice allows you to set up
  719.             descriptions and formatting sequences for up to five
  720.             "printers".  A printer is any output device, including files on
  721.             disk or the display.  The default configuration has four pre-
  722.             configured printers - Epson on LPT1, HP laser on LPT2, disk
  723.             file and screen.  You may need to change the printer ports if
  724.             your system differs.  QBook also allows you to change the
  725.             output device each time you print something.  This would allow
  726.             you to print an index with HP Laser escape sequences to a disk
  727.             file, for example, without requiring a separate printer setup
  728.             for  both printer and disk.
  729.  
  730.             QBook always expects to be able to print 80 columns across, if
  731.             you make any changes to the standard printer configuration,
  732.             make sure your paper width, margins and print pitch provide 80
  733.             columns for text.
  734.  
  735.             The following configuration options are available:
  736.  
  737.             Description: This is the name of the printer configuration you
  738.                          are editing.  All available printer setups will be
  739.                          presented in a popup menu whenever you print a
  740.                          recipe or index.
  741.             Output to:   This tells QBook where to send the printout.  It
  742.                          may be a printer port (PRN, LPT1, LPT2, LPT3,
  743.                          COM1, COM2...), a disk file (RECIPE.PRN,
  744.                          INDEX.PRN) or it may be left blank.   If left
  745.                          blank, output will be displayed on the screen.
  746.             Page Length: This is the number of lines the printer is capable
  747.                          of printing on a single sheet of paper.  It tells
  748.                          QBook where to put the page breaks.  If you do not
  749.                          want page breaks, set this to zero.  If you are
  750.                          printing to the screen, this option is ignored.
  751.             Margins
  752.             Top/Bottom:  This tells QBook how many lines to leave at the
  753.                          top and bottom of each page.
  754.  
  755.           QBook Version 1.00     User's Guide                  Page:18
  756.  
  757.  
  758.             Init
  759.             DeInit:      These are the printer codes QBook sends before
  760.                          starting the printout and after printing is
  761.                          complete.  These might be used to switch a printer
  762.                          into and out of compressed type mode to print on
  763.                          recipe cards, for example.  Printer codes must be
  764.                          entered as ASCII values separated by spaces.  For
  765.                          example,. ESC-B would be entered as "27 66".
  766.  
  767.             Bold On
  768.             Bold Off:    These are the printer codes QBook sends to print
  769.                          text in bold and to turn bold off.  As with Init
  770.                          and DeInit, they should be entered as ASCII values
  771.                          separated by spaces.
  772.  
  773.  
  774.           Editor Options
  775.  
  776.             This option allows you to specify the editor QBook will start
  777.             when you want to edit or add recipes.  Unless you change this
  778.             option, QBook will use its own built in editor.  Your other
  779.             choices are to use MS-DOS's EDIT or SemWare's Qedit.  You can
  780.             also specify the editor of your choice by selecting "Customized
  781.             Editor".
  782.  
  783.             To enter a customized editor, enter the command you normally
  784.             type to start your editor except replace the file name with a
  785.             "%F".  For example, if your editor is called "B", you would
  786.             enter "B %F" and QBook would then start "B" when you want to
  787.             edit a recipe.  If your editor is not in your system path, you
  788.             need to specify the fully qualified path so that QBook can find
  789.             it.  For example, if B.EXE is in the directory c:\editor, you
  790.             would enter "C:\EDITOR\B.EXE %F" as your editor command.
  791.  
  792.           QBook Version 1.00     User's Guide                  Page:19
  793.  
  794.  
  795.           Recipe Storage Options
  796.  
  797.             These options tell QBook how to store your recipe files.
  798.             Unless you change things, QBook will store your recipes in
  799.             files of 100 recipes each, using its own internal compression
  800.             routines.  The compression technique QBook uses is very fast
  801.             and does a fairly good job of compressing text files.  Overall,
  802.             you should see a 25-30% reduction in size.
  803.  
  804.             If you are using "disk doubling" technology such as Stacker or
  805.             DoubleSpace, you will probably gain better compression and
  806.             better performance by turning off compression completely.  You
  807.             should see about a 50% compression ratio or better.
  808.  
  809.             If you are not using a program like Stacker or DoubleSpace, and
  810.             you would like to save more disk space than you do with QBook's
  811.             internal compression, you can use an external data compression
  812.             program such as PKZIP, LHARC or ARJ.  These programs can
  813.             achieve 30-50% data compression, but performance may suffer
  814.             significantly.  QBook comes with options for each of the three
  815.             compression programs mentioned above, or you can use another by
  816.             choosing the Customized Compression option from the menu and
  817.             entering the appropriate commands.
  818.  
  819.             You will need to enter the commands needed to get or extract a
  820.             file from the archive, put a file into an archive, move a file
  821.             into an archive (deleting the original) and delete a file from
  822.             an archive.  You will also need to enter the default file
  823.             extension used by the archive program you are configuring.
  824.  
  825.             For each command, replace the name of the archive file with a
  826.             %A and the name of the file being worked with with a %F.  You
  827.             might want to choose one of the preconfigured commands and
  828.             modify it to use your program instead.
  829.             As with the editor command, if the program is not in your
  830.             system path, you need to enter the fully qualified path name.
  831.  
  832.             You may also choose to change the number of recipes QBook
  833.             stores in each compressed file.  Your choices are 20, 50, 100,
  834.             200 and 1000.  Smaller files tend to be faster (especially with
  835.             external compression programs) but have more overhead, which
  836.             may reduce their compression ratio.
  837.  
  838.           QBook Version 1.00     User's Guide                  Page:20
  839.  
  840.  
  841.           Data File Directories
  842.  
  843.             Choosing this option allows you to tell QBook where to put its
  844.             data files.  Usually, these directories would be subdirectories
  845.             below QBook's main directory.  The three types of files QBook
  846.             needs to store are Datafiles, which are the main index files
  847.             and QBook's help files, the Work files, which are files created
  848.             during a QBook session but which are not permanent (a RAM disk
  849.             is a good choice for a Work Directory), and Archive files,
  850.             which are the files QBook uses to store recipes in compressed
  851.             form.
  852.  
  853.             If you make changes, QBook will create the directories if
  854.             necessary, and ask if you'd like to move the existing files to
  855.             their new location.  Normally you would choose Yes, unless you
  856.             have previously moved them yourself.
  857.  
  858.  
  859.           QBook Utilities
  860.  
  861.             The QBook utilities are used to repair or rebuild an index if
  862.             you start having problems with your database.  Normally, this
  863.             will not be necessary, but if you lose power during the middle
  864.             of a disk operation, or have a partial disk failure, you may
  865.             need to repair your index files.
  866.  
  867.             The Repair option simply checks the index files for possible
  868.             problems and attempts to fix them.  It does not compare the
  869.             index files to the actual recipe files.
  870.  
  871.             The Rebuild option will completely re-create the index files by
  872.             looking at each recipe file and re-indexing it as if you had
  873.             just added it to your database.
  874.  
  875.             The Keyword Maintenance option allows you to edit change all
  876.             occurrences of one keyword to another.  For example, if you
  877.             have some recipes with the keyword "Chicken" and some with the
  878.             keyword "Poultry" and want to change them all to "Poultry",
  879.             this is where you would do so.
  880.  
  881.  
  882.           Registration Information
  883.  
  884.             Once you have registered QBook, you can enter your name and
  885.             registration key here, and QBook will stop nagging you to
  886.             register every time you start the program.  It will still
  887.             display a status screen each time you start it, but any key
  888.             will bypass the screen.  You may also put anything on the
  889.             command line and the screen will not be displayed at all once
  890.             you have registered.
  891.  
  892.           QBook Version 1.00     User's Guide                  Page:21
  893.  
  894.  
  895.                                 Technical Information
  896.  
  897.  
  898.           QBook was written in C++ using Borland C++  version 3.1.
  899.  
  900.           The screen library used is Mike Smedley's Shareware function
  901.           library, CXL (version 5.2).  Some of the database routines are
  902.           from Mix Software's C/Database Toolchest.  The internal editor is
  903.           based on code from Dlugosz Software's C Editor Toolbox.  The
  904.           internal compression routines are adapted from the book  "The
  905.           Data Compression Book" by Mark Nelson.
  906.           QBook's data  files
  907.  
  908.           QBook creates three index files.  ENTRIES.QBK is used by QBook to
  909.           track how many recipes are in the database and the recipe numbers
  910.           that are in use.  TITLES.QBK is  list of recipe titles used for
  911.           quick lookup.  It contains as many 61 byte records as you have
  912.           recipes.  KEYWORD.QBK and KEYWORD.IDX are the main index files
  913.           used by QBook.Their size depends on the number of recipe titles
  914.           and keywords. These files are stored in the DATA directory
  915.           defined in configuration.  All of these can be recreated with the
  916.           Rebuild utility option if they become damaged.
  917.  
  918.           The files MESSAGES.IDX and MESSAGES.QBK are used by QBook to
  919.           store informational messages.  QBOOK.HLP is QBook's help file for
  920.           online documentation.  The optional file, TEMPLATE.QBK contains
  921.           text that QBook will use as the base text for all new recipes
  922.           that are created.  See Adding Recipes for additional information.
  923.           All of these files are in the DATA directory.
  924.  
  925.           QBook expects to find the file QBOOK.CFG either in the current
  926.           working directory or in the same directory as QBOOK.EXE.  This
  927.           file contains the configuration information for QBook.
  928.  
  929.           Recipes are given a name of the form: RECIPE##.###, where ##,###
  930.           is the recipe number from 1 to 65,535.  These files normally
  931.           won't be present except as temporary work files (they are kept in
  932.           the archive files), but if you reboot or lose power while using
  933.           QBook, they may be there.  They will be moved to the proper
  934.           archive file the next time you run QBook.  These files are stored
  935.           in the WORK directory.
  936.  
  937.           Finally, the REC##### files contain the RECIPE##.### files. The
  938.           extension of these files depends on the compression tool you use
  939.           (internal compression and no compression both create two files
  940.           with extensions of .QBK and .IDX).  These files are stored in the
  941.           ARCHIVE directory.
  942.  
  943.           QBook maintains all these files for you, so all you need to do is
  944.           back them up regularly in case of disk failure or human error.
  945.           Make sure you get all the archive files AND the TITLES, KEYWORD
  946.           and ENTRIES files when you back up the data.
  947.  
  948.           QBook Version 1.00     User's Guide                  Page:22
  949.  
  950.  
  951.                                   Registration Form
  952.  
  953.  
  954.           QBook is Shareware.  If you use it beyond the thirty day
  955.           evaluation period, you must register it.
  956.  
  957.           For $20 (US) you will receive a registration key which will
  958.           disable the opening nag screen.  If you would like a diskette
  959.           containing the current version of QBook, please send a self-
  960.           addressed, stamped diskette mailer and a formatted diskette along
  961.           with your registration.
  962.  
  963.           Please send your registration to:
  964.  
  965.           Robert J. Butler
  966.           2023 38th St. NW
  967.           Rochester, MN  55901
  968.  
  969.  
  970.  
  971.           - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  972.  
  973.  
  974.                             QBook 1.00    registration form
  975.  
  976.  
  977.  
  978.           Name:__________________________________________
  979.  
  980.           Address:____________________________________________________
  981.  
  982.                   ____________________________________________________
  983.  
  984.  
  985.           EMail address (if any):_______________________________
  986.  
  987.  
  988.                          ____ Copies of QBook @ $20 each: $__________
  989.  
  990.  
  991.           Comments/Problems:
  992.